home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #2 / Monster Media No. 2 (Monster Media)(1994).ISO / pcboard / bcfal11b.zip / AREA.DOC < prev    next >
Text File  |  1994-07-08  |  5KB  |  117 lines
  1.  
  2.         ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  3.          ────────═════════φ  PCB File Area Lister PPE  φ══════════─────────
  4.         ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  5.  
  6.                                  (C) BlackCat
  7.                          Version 1.1ß
  8.  
  9.         ────────────────────────────────────────────────────────────────────
  10.  
  11.         This is a lightbar driven file area lister. Initialy this was only 
  12.     a PPE that read the conference information and showed a simple 
  13.     file area menu. But I wanted a better menu with file/byte totals and 
  14.     since I had coded a directory menu creator I decided to combine the
  15.     two. Here's the result and I think you may like it ;)
  16.  
  17.         
  18.         ────────────────────────────────────────────────────────────────────
  19.              ──────────═════════φ  INSTALLATION  φ══════════────────────
  20.         ───────────────────────────────────────────────────────────────────
  21.  
  22.         ■ Make sure that you've extracted the zip with the -d option (or
  23.       if you're using any other program to extract this make sure you 
  24.       extract it so that empty directories in the zip are also created).
  25.  
  26.         ■ Edit DM.CFG and make sure the path to your conference (CNAMES.@@@) 
  27.       file is correct.
  28.  
  29.     ■ Run DM.EXE. This will generate the directory files in the DIRS 
  30.       directory with file/bytes summary information.
  31.  
  32.       To write a single directory in case of any problems or when you just
  33.       want to update a directory menu that you've changed use 'DM <number>',
  34.       which will only create the requested conference directory.
  35.  
  36.       The reason that DM.EXE does not overwrite your real directory files is
  37.       because the files created in DIRS contain no headers/footers (these 
  38.       are handled by the PPE, see below)
  39.  
  40.     ■ Replace your 'F' command with AREA.PPE the following way and that 
  41.       should be it.
  42.  
  43.                1 - run PCBSETUP
  44.            2 - Press B B 
  45.            3 - Move to your CMD.LST file and press F2 to edit it.
  46.            4 - Enter 'F' as the command, the security you want and the 
  47.                full path and name of AREA.PPE.
  48.  
  49.  
  50.     
  51.         ────────────────────────────────────────────────────────────────────
  52.             ──────────═════════φ  CONFIGURATION  φ══════════────────────
  53.         ────────────────────────────────────────────────────────────────────
  54.  
  55.     DM is totally configurable by the use of replacement codes in CM.CFG.
  56.     You can arrange the codes anyway you like. You can even remove a code
  57.     with information you don't want/need. 
  58.  
  59.     The replacement codes allowed for a directory line in DM.CFG are:
  60.  
  61.            %NR%       - Directory number. (length 3)
  62.            %DESC%     - Directory description. (length 35)
  63.            %FILES_R%  - # of files in directory. (length 9)
  64.            %BYTES_R%  - # of bytes in directory. (length 15)
  65.  
  66.  
  67.     The following codes are also allowed in the menu display file (MENU) 
  68.     file. 
  69.  
  70.            %TOTF_R%   - Total number of files in conference directories.
  71.                         (length 9)
  72.            %TOTB_R%   - Total number of bytes in conference directories.
  73.                         (length 15)
  74.  
  75.         The '_R' in some codes above means right justification, use '_L' for
  76.     left justification.
  77.  
  78.         CFG2.ZIP contains an example of another codes/hdr/ftr configuration,
  79.     try it and see if you like it. It's a metallic menu setup like seen
  80.     in so many other utils. After extracting CFG2.ZIP don't forget to 
  81.     run DM.EXE again, to create the new directory lines.
  82.  
  83.  
  84.     The command line syntax for DM is:
  85.            
  86.                         DM [NR] [/v] [/r]
  87.  
  88.            NR = Conference to create directory menu for. Only the directory
  89.                 menu for this conference is created. Without this option
  90.             the directory menus for ALL conferences are created.
  91.            /v = Verbose (for testing purposes).
  92.            /r = Check for REAL file existance when calculating directory
  93.                 totals. Normally the values found in the directory files
  94.             are just added together without actually checking if the
  95.             files are on the disk. Using this option is slower but
  96.             also more accurate, so use it if the other method seems
  97.             to get it wrong.
  98.  
  99.  
  100.         ────────────────────────────────────────────────────────────────────
  101.                ──────────═════════φ  AUTHOR  φ══════════────────────
  102.         ────────────────────────────────────────────────────────────────────
  103.  
  104.     If you find any bugs or have any comments/suggestions/additions you
  105.     want you can contact me at MaFIA Godfather WHQ under handle El GaTO or 
  106.     mail me on internet at: an42144@anon.penet.fi
  107.     
  108.     I've been having problems with the anon server. Not only has it gotten 
  109.     too slow but it also doesn't allow reasonably big files (>40K) to be 
  110.     mailed through it. So if you want me to send you the newest version of 
  111.     this or any other of my PPEs send me your non anonymous address, and I
  112.     will forward you the files. Alternatively you can also get the newest
  113.     versions at wuarchive.wustl.edu in directory /pub/MSDOS_UPLOADS/ppe.
  114.     If anyone knows of any better (internet) places to put these I'm open
  115.     to suggestions.
  116.  
  117.